LEGION Model Builder Help

Setting Direction Modifier parameters

This procedure assumes you have already drawn a Direction Modifier and the 'Edit Direction Modifier <name>' dialog box is displayed.

To set Direction Modifier parameters:

  1. Enter a name for the Direction Modifier in the 'Name' box (or leave it as it is if you are happy with the existing name).
  2. In the ‘Action’ portion of the dialog, select one, two or all of the following options, depending on how you want the Direction Modifier to affect Entities:
    • Change Entity Type to – select an Entity or Supply Type from the adjacent drop-down list.
    • Change target – you will need to link the Direction Modifier to other targets for this to work. If you choose this, you will need to select either 'Specify Links' or 'Revert to final destination'. If you choose the former, you will need to specify links on the 'Links' tab; if you choose the latter, Entities will continue to their Final Destination.
    • Change final destination – You will need to add Final Destinations to the Direction Modifier for this to work.
  3. In the ‘Scope’ portion of the dialog, enter a percentage value between 0 and 100 in the box labelled Percentage of entities to affect.

    If you set this to fewer than 100%, then the number of Entities that the ‘Scope’ portion affects will be scaled accordingly. For example, assume that this value has been set to 40%. If at a given moment in time a Direction Modifier's occupancy is 600 Entities and the Scope attribute is set to ‘Always’ or there is an active Event Profile that affects 600 or more Entities at that precise moment, then only 240 Entities will actually be affected in that time-step.

  4. Select a Data Profile from the drop-down list labelled 'Profile'.
  5. If you want to apply conditions to the Direction Modifier, check the box labelled ‘use condition’ to enable the 'Conditions' tab. See Conditions in Models and in particular, "To set up a Condition:" in Setting up Conditions for further information.

    If you wish to apply any restrictions to the condition, enter values for the following restrictions (details in Restrictions ):

    • Time before action
    • Minimum activity period
    • Maximum activity period
    • Minimum time between Actions
  6. Click on the Entity Filter tab and complete the Filtering parameters (for further information on filtering, see Specifying filter settings ).
  7. Click on the Links tab and complete the link details (for further information, see Linking methods ).
  8. If applicable, click on the Target Rules tab and set up the appropriate rules. See Setting Target Rules for full instructions.
  9. If you checked the box labelled ‘Change final destination’ earlier, click on the Final Destinations tab and click the Add Destination button, otherwise proceed to step 14.

    The ‘Select final destinations’ dialog is displayed.

  10. Expand the object trees within the dialog box and select one or more destinations (press and hold the <Ctrl> key while clicking to select more than one).
  11. Click OK to add the destination(s).
  12. If you want to distribute Entities evenly across your destinations, click Uniform Distribution If you want to input the distribution manually, click next to each destination name and drag the distribution bar to set the percentage (they must equal 100%).
  13. Click OK to return to the main parameters tab.
  14. Click OK to save the parameters.